--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
lang/README.zh.md v4.5.0-rc.1 (62ba0631) Text, 12.13 KB
Reticulum MeshChatX
Liam Cottle 开发的 Reticulum MeshChat 的一个功能丰富的深度修改分支。
本项目独立于原始 Reticulum MeshChat 项目，与其无关联。
• 网站: meshchatx.com
• 官方镜像: github.com/Quad4/MeshChatX — 目前亦用于 Windows 与 macOS 构建。
• 变更日志: CHANGELOG.md
• TODO: Boards
与 Reticulum MeshChat 的重要差异
• 使用 LXST
• 以原生 SQL 替代 Peewee ORM
• 以原生 T383838fetch 替代 Axios
• 使用最新 Electron
• T383838.whl 内置 Web 服务器与前端资源，便于多种部署方式
• i18n
• 使用 PNPM 与 Poetry 管理依赖
│ [!WARNING] MeshChatX 不保证与旧版 Reticulum MeshChat 的数据兼容。迁移或测试前请备份数据。
│ [!WARNING] 旧系统尚未完全支持。当前最低要求：Python T383838>=3.11，Node T383838>=22（Electron 使用 Node 22；CI
│ 可使用更高版本）。
系统要求
• Python T383838>=3.11（来自 T383838pyproject.toml）
• Node.js T383838>=22（来自 T383838package.json）
• pnpm T38383810.32.1（来自 T383838package.json）
• Poetry（用于 T383838Taskfile.yml 与 CI 工作流）
T282828
task install
task lint:all
task test:all
task build:all
安装方式
请按运行环境与打包形式选择。
┌─────────────────────┬──────────┬──────────────────────────┬─────────────────────────────────────┐
│ 方式 │ 包含前端 │ 架构 │ 适用场景 │
├─────────────────────┼──────────┼──────────────────────────┼─────────────────────────────────────┤
│ Docker 镜像 │ 是 │ T383838linux/amd64, T383838linux/arm64 │ Linux 服务器快速部署 │
│ Python wheel (T383838.whl) │ 是 │ 任何 Python 支持的架构 │ 无需 Node 构建的无头/Web 服务器安装 │
│ Linux AppImage │ 是 │ T383838x64, T383838arm64 │ 便携式桌面使用 │
│ Debian 包 (T383838.deb) │ 是 │ T383838x64, T383838arm64 │ Debian/Ubuntu 安装 │
│ RPM 包 (T383838.rpm) │ 是 │ 取决于 CI │ Fedora/RHEL/openSUSE │
│ 从源码 │ 本地构建 │ 主机架构 │ 开发与自定义构建 │
└─────────────────────┴──────────┴──────────────────────────┴─────────────────────────────────────┘
说明:
• 发布工作流明确构建 Linux T383838x64 与 T383838arm64 的 AppImage + DEB。
• RPM 亦会尝试构建，成功时上传。
快速开始: Docker
T282828
docker compose up -d
默认 compose 文件映射:
• 主机 T383838127.0.0.1:8000 -> 容器端口 T3838388000
• T383838./meshchat-config -> T383838/config 持久化
如遇权限问题:
T282828
sudo chown -R T79c0ff1000:1000 ./meshchat-config
从发行版安装
1) Linux AppImage (x64/arm64)
1. 从发行版下载 T383838ReticulumMeshChatX-v<版本>-linux-<架构>.AppImage。
2. 赋予执行权限并运行:
T282828
chmod +x ./ReticulumMeshChatX-v*-linux-*.AppImage
./ReticulumMeshChatX-v*-linux-*.AppImage
2) Debian/Ubuntu T383838.deb (x64/arm64)
1. 下载 T383838ReticulumMeshChatX-v<版本>-linux-<架构>.deb。
2. 安装:
T282828
sudo apt install ./ReticulumMeshChatX-v*-linux-*.deb
3) RPM 系统
1. 若发行版中存在，下载 T383838ReticulumMeshChatX-v<版本>-linux-<架构>.rpm。
2. 安装:
T282828
sudo rpm -Uvh ./ReticulumMeshChatX-v*-linux-*.rpm
4) Python wheel (T383838.whl)
发行版 wheel 包含已构建的前端资源。
T282828
pip install ./reticulum_meshchatx-*-py3-none-any.whl
meshchatx --headless
亦支持 T383838pipx:
T282828
pipx install ./reticulum_meshchatx-*-py3-none-any.whl
从源码运行（Web 服务器模式）
在开发或需要本地定制构建时使用。
T282828
git clone https://git.quad4.io/RNS-Things/MeshChatX.git
Tffa657cd MeshChatX
corepack Tffa657enable
pnpm install
pip install poetry
poetry install
pnpm run build-frontend
poetry run python -m meshchatx.meshchat --headless --host T79c0ff127.0.0.1
在沙盒中运行（Linux）
若要在额外隔离文件系统的情况下运行原生 T383838meshchatx（别名：T383838meshchat），可使用 Firejail 或 Bubblewrap（T383838bwrap），同时保留 Reticulum 与 Web 界面所需的网络访问。完整示例（pip/pipx、Poetry、USB 串口说明）见:
在提供已捆绑或已同步的 T383838meshchatx-docs 时，应用内 文档（MeshChatX 文档）列表亦会显示同一页面。
Linux 桌面：绘文字字体
绘文字选择器使用系统字体（Electron/Chromium）渲染标准 Unicode 绘文字。若显示为空白方框（“豆腐块”），请安装彩色绘文字字体包并重启应用。
┌────────────────────────────┬───────────────────────────────────────────────────────────────────┐
│ 发行版（示例） │ 软件包 │
├────────────────────────────┼───────────────────────────────────────────────────────────────────┤
│ Arch Linux、Artix、Manjaro │ T383838noto-fonts-emoji（T383838sudo pacman -S noto-fonts-emoji） │
│ Debian、Ubuntu │ T383838fonts-noto-color-emoji（T383838sudo apt install fonts-noto-color-emoji） │
│ Fedora │ T383838google-noto-emoji-color-fonts │
└────────────────────────────┴───────────────────────────────────────────────────────────────────┘
安装后若仍异常，可运行 T383838fc-cache -fv。可选：最小安装可再装 T383838noto-fonts 以覆盖更多符号。
从源码构建桌面包
脚本定义于 T383838package.json 与 T383838Taskfile.yml。
Linux x64 AppImage + DEB
T282828
pnpm run dist:linux-x64
Linux arm64 AppImage + DEB
T282828
pnpm run dist:linux-arm64
RPM
T282828
pnpm run dist:rpm
或通过 Task:
T282828
task dist:fe:rpm
架构支持
• Docker 镜像: T383838amd64, T383838arm64
• Linux AppImage: T383838x64, T383838arm64
• Linux DEB: T383838x64, T383838arm64
• Windows: T383838x64, T383838arm64（提供构建脚本）
• macOS: 提供构建脚本（T383838arm64、T383838universal），适用于本地构建环境
• Android: 原生 APK — ABI T383838arm64-v8a、T383838x86_64 与 universal
Android
MeshChatX 支持构建原生 Android APK（不仅限于 Termux）。
从源码构建 APK
在仓库根目录执行:
T282828
T8b949e# 1) 构建 android/app/build.gradle 所需的 Chaquopy 轮子
bash scripts/build-android-wheels-local.sh
T8b949e# 2) 构建两种 APK 变体
Tffa657cd android
./gradlew --no-daemon :app:assembleDebug :app:assembleRelease
APK 输出（ABI 分包与 universal APK；见 T383838android/app/build.gradle 中的 T383838splits { abi { ... } }）:
调试（T383838android/app/build/outputs/apk/debug/）:
• T383838app-arm64-v8a-debug.apk（ARM64 设备）
• T383838app-x86_64-debug.apk（x86_64 模拟器）
• T383838app-universal-debug.apk（所有已打包 ABI 的单包）
发布（T383838android/app/build/outputs/apk/release/）:
• T383838app-arm64-v8a-release-unsigned.apk
• T383838app-x86_64-release-unsigned.apk
• T383838app-universal-release-unsigned.apk
说明:
• 若未配置签名，发布构建默认未签名。
• 若只需一种变体，可运行 T383838:app:assembleDebug 或 T383838:app:assembleRelease。
• Android 目标 ABI 为 T383838android/app/build.gradle 中配置的 T383838arm64-v8a 与 T383838x86_64。
更多文档:
配置
┌────────────────────────┬──────────────────────────────────────┬───────────┬──────────────────────┐
│ 参数 │ 环境变量 │ 默认值 │ 说明 │
├────────────────────────┼──────────────────────────────────────┼───────────┼──────────────────────┤
│ T383838--host │ T383838MESHCHAT_HOST │ T383838127.0.0.1 │ Web 服务器绑定地址 │
│ T383838--port │ T383838MESHCHAT_PORT │ T3838388000 │ Web 服务器端口 │
│ T383838--no-https │ T383838MESHCHAT_NO_HTTPS │ T383838false │ 禁用 HTTPS │
│ T383838--ssl-cert / T383838--ssl-key │ T383838MESHCHAT_SSL_CERT / T383838MESHCHAT_SSL_KEY │ （无） │ PEM 证书与私钥路径… │
│ T383838--rns-log-level │ T383838MESHCHAT_RNS_LOG_LEVEL │ （无） │ Reticulum（RNS）日… │
│ T383838--headless │ T383838MESHCHAT_HEADLESS │ T383838false │ 不自动打开浏览器 │
│ T383838--auth │ T383838MESHCHAT_AUTH │ T383838false │ 启用基本认证 │
│ T383838--storage-dir │ T383838MESHCHAT_STORAGE_DIR │ T383838./storage │ 数据目录 │
│ T383838--public-dir │ T383838MESHCHAT_PUBLIC_DIR │ 自动/捆绑 │ 前端文件目录（无捆… │
└────────────────────────┴──────────────────────────────────────┴───────────┴──────────────────────┘
分支
┌────────┬──────────────────────────────────────────┐
│ 分支 │ 用途 │
├────────┼──────────────────────────────────────────┤
│ T383838master │ 稳定发布。仅限生产就绪代码。 │
│ T383838dev │ 活跃开发。可能包含不稳定或不完整的更改。 │
└────────┴──────────────────────────────────────────┘
开发
T383838Taskfile.yml 中的常用任务:
T282828
task install
task lint:all
task test:all
task build:all
T383838Makefile 快捷方式:
┌──────────────┬─────────────────────────────┐
│ 命令 │ 说明 │
├──────────────┼─────────────────────────────┤
│ T383838make install │ 安装 pnpm 与 poetry 依赖 │
│ T383838make run │ 通过 poetry 运行 MeshChatX │
│ T383838make build │ 构建前端 │
│ T383838make lint │ 运行 eslint 与 ruff │
│ T383838make test │ 运行前端与后端测试 │
│ T383838make clean │ 移除构建产物与 node_modules │
└──────────────┴─────────────────────────────┘
版本
本仓库当前版本: T3838384.5.0。
• JavaScript/Electron 版本以 T383838package.json 为准。
• T383838meshchatx/src/version.py 通过以下命令与 T383838package.json 同步:
T282828
pnpm run version:sync
发布时请保持相关字段一致（T383838package.json、T383838pyproject.toml、T383838meshchatx/__init__.py）。
安全
添加语言
语言由目录自动发现。添加新语言只需一个 JSON 文件:
1. 从 T383838en.json 生成空白模板:
T282828
python scripts/generate_locale_template.py
将写入 T383838locales.json，所有键值为空字符串。
2. 重命名并移入语言目录:
T282828
mv locales.json meshchatx/src/frontend/locales/xx.json
3. 在文件顶部设置 T383838_languageName 为该语言的母语名称（例如 T383838"Espanol"、T383838"Francais"）。将显示在语言选择器中。
4. 翻译其余全部值。
5. 校验键一致性: T383838pnpm test -- tests/frontend/i18n.test.js --run
无需其他代码更改。应用、语言选择与测试在构建时从 T383838meshchatx/src/frontend/locales/ 发现语言文件。
致谢
• Liam Cottle - 原始 Reticulum MeshChat
• RFnexus - Micron 解析器（JavaScript）
• markqvist - Reticulum, LXMF, LXST
许可证
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────